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1.  Function  of  the  Tailoring  Tool 

The  Tailoring  Tool  is  designed  in  conjunction  with  the 
Comparator  and  Analyser  Tool,  to  provide  assistance  to 
clients  and  Ada*  Validation  Facilities  (AVFs)  in  the 
preparation  of  an  Ada  Compiler  Validation  and  the  checking 
of  the  results  obtained  from  using  the  Ada  Compiler 
Validation  Capability  (ACVC)  test  suite.  Its  objectives 
are  to  perform  macro  substitutions  and  to  build  an 
information  file,  which  will  provide  input  to  the  Comparator 
and  Analyser  tool. 


2 .  Operating  System  Criteria 

The  Tailoring  Tool  requires  that  the  following  operating 
system  criteria  are  available  : 

a)  The  system  must  allow  at  least  8  character  filenames. 

b)  The  operating  system  must  allow  filenames  without 
extensions  in  order  to  allow  the  Tailoring  Tool  to  open 
its  output  files. 

If  the  users  operating  system  does  not  support  these 
criteria  then  please  contact  the  AVF  that  supplied  the 
software-,  who  will  pass  the  comments  on  to  the  NCC.  A  list 
of  all  the  AVFs  is  found  in  Appendix  C. 


*  Ada  is  a  registered  trademark  of  the  US  Government  (Ada  Joint 
Program  Office) 
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Within  the  Tailoring  Tool  the  following  naming  protocol  is 
required  for  filenames  : 


FILENAME . EXTENSION 


3.1  Filename 

The  convention  used  to  allocate  every  filename  within 
the  Tailoring  Tool  (except  those  which  have  been  split, 
see  3.2,)  is  as  follows  : 


1 

Position  | 

Description 

1 

Type 

1 

1 

1  | 

Test  Description 

1 

Char 

1 

1 

2  1 

LRM  Chapter  Number 

I 

Hex 

1 

1 

3  1 

LRM  Section 

1 

Hex 

1 

1 

4  1 

LRM  Sub-Section 

1 

A/N 

1 

1 

5,6  | 

Test  Objective 

1 

Dec 

1 

1 

1 

7  1 

Sub-objective 

1 

Char 

1 

t 

1 

1 

The  positions  below  are  used  only  if 

the 

test 

1 

1 

requires 

the  compilation  of  multiple 

files . 

1 

1 

1 

1 

8  1 

Compilation  number 

1 

A/N 

1 

1 

9  1 

Main  sub-program  compilation  | 

M 

1 

1 

1 

unit 

1 

1 

Char  —  Character  Hex  --  Hexidecimal 

A/N  —  Alpha-Numeric  M  —  The  Character  ' M' 

Dec  —  Decimal  LRM  —  Language  Reference 

Manual 

This  is  in  complianc-  with  the  naming  protocol  adopted 
by  the  AJPO  whereby  individual  tests  are  uniquely 
identifiable  by  the  characters  in  positions  2  to  7 
inclusive . 
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In  tests  where  there  is  more  than  one  compilation  unit 
(multi-file  test)  ,  indicated  by  the  use  of  the 
compilation  number,  all  the  units  must  be  compiled 
before  the  test  is  linked.  In  a  multi-file  test  a 
zero  in  position  8  indicates  that  this  file  must  be 
compiled  first.  The  order  of  compilation  follows  the 
order  specified  in  the  ACVC  logbook.  An  'M'  in  the 
main  sub-program  compilation  unit  indicates  the  main 
unit  in  a  multi-file  test. 
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3 . 2  Split  Filenames 

A  Split  file  is  determined  necessary  in  order  to  :- 

o  Allow  specific  lines  within  a  particular  test 

(normally  'B'  tests)  to  comply  with  the 
requirement  of  the  corresponding  comment. 

o  Allow  a  compilation  unit  to  compile  and  run 

successfully . 

All  Splits  must  be  agreed  by  the  AVF  or  AVO. 

The  naming  convention  required  to  be  followed  for  the 

Split  files  within  the  Tailoring  Tool  is  as  follows: 


1 

Position 

|  Description 

l 

Type  | 

1 

1  — >  6 

|  As  original  filename 

1 

Char  | 

1 

1 

7 

|  Counter  from  0-9  incremented 
|  by  Position 

1 

1 

Dec  | 

1 

1 

8 

|  Counter 

1 

36  | 

Char  —  Character  36  —  Base  36  (0  to  9  and  A  to  Z) 
Dec  —  Decimal 

The  numbering  of  a  Split  (given  by  positions  7  and  8) 
must  be  contiguous  for  all  tests  split  in  a  chapter- 
section-subsection  set. 
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3 . 3  Extensions 

The  extensions  that  reside  within  the  A CVC  test  suite 
have  specific  meanings  within  the  Tailoring  Tool. 
These  are  as  follows  : 


Extension 

|  Description 

1 

TST 

1 

|  This  file  will  need  to  have  the  Macro 

1 

1 

|  substitution. 

1 

ADA 

|  This  test  incorporates  Standard 

1 

|  features  of  the  language. 

1 

DEP 

|  There  are  Optional  Implementation- 
|  Dependent  features  in  this  test. 

! 

; 

If  the  users  operating  system  does  not  allow  three 
character  extensions  then  the  tool  will  truncate  the 
extension  down  (See  Section  4.3.1).  The  minimum 

extension  size  must  be  one  character  and  even  then  the 
test  file  extensions  retain  their  meaning  within  the 
Tailoring  Tool  and  the  ACVC. 
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4 •  Tool  Implementation  and  Installation 

To  allow  the  tool  to  be  built  and  run  using  different 
operating  systems,  the  Tailoring  Tool  is  supplied  as  a 
series  of  source  cede  files  written  in  Ada  which  need  to  be 
installed  and  linked  into  the  Ada  Library.  TEXTIO  is  the 
only  one  Generic  Xnstanstiation  used  within  the  code. 


4  - 1  Name  and  Content  of  Supplied  Code 


MAIN. ADA 
BOLD  TAB. ADA 
PRO  FILE. ADA 
PRO  TEST. ADA 
PRO  SPL-  .ADA 
TAILOR. ADA 
WRITE. ADA 


CHECK. ADA 

4 • 2  Compiling  and 


Main  Procedure 

Sub-procedure 

Sub-procedure 

Sub-procedure 

Sub-procedure 

Sub -procedure 

Sub-procedure 


Sub-procedure 

Linkage 


Main  control  block 
Build  data  tables 
Process  FNAMES  file 
Process  test  files 
Process  split  files 
Tailor  files 
Write  to  Tailoring 
Tool  Information 
File  (TTINF) 

Check  completeness 


The  following  compilation  procedures  will  result  in  an 
executable  Tailoring  Tool.  There  is  no  fixed  order 
stated  here,  for  each  system  will  have  its  own  protocol 
for  compiling  and  linking. 


o  Create  a  new  application  library  with  the 
overwrite  facility  enabled. 

o  Compile  each  of  the  Tailoring  Tool  files. 

o  Bind  all  the  units  of  application  code  from  the 
application  library  allowing  the  linking  of  the 
program  to  run. 

o  Link  the  object  code  to  create  an  executable  file. 
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4 . 3  Activating  the  Tailoring  Tool 

Before  activating  the  Tailoring  Tool  the  user  must 
first  make  sure  that  : 

o  All  the  A  CVC  Test  Suite  tests  must  be  in  one 

directory. 

o  All  the  User  Input  Files  must  be  set  up  and  in  the 
same  directory  as  the  Test  Suite.  These  Input 
Files  are  described  in  Section  5. 

o  This  directory  must  be  in  the  scope  of  the 

executable  image  of  the  Tailoring  Tool. 

The  Tailoring  Tool  will  be  activated  by  running  the 
executable  file  'MAIN'.  The  following  tasks  will  be 
undertaken . 

4.3.1  User  Inputs 

When  the  Tailoring  Tool  is  activated  the  user 
will  be  asked  to  input  information  as  follows 


a)  Today's  date  -  this  is  to  be  put  in  the 
form  dd:mm:yyyy  (eg  23:04:1988). 

b)  A  User's  Comment  -  to  go  at  the  top  of 
the  macro  replacement  file.  This  has  a 
maximum  of  20  characters  and  should  be 
used  to  identify  the  particular  run. 

c)  Whether  or  not  the  system  is  limited  to 
8  character  filenames. 

d)  Whethe_  the  system  supports  3  or  more 
character  extensions.  If  the  system 
cannot  support  3  or  more  character 
extensions,  then  the  user  must  state 
the  maximum  extension  size. 
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4.3.2  Tables 


The  internal  table  structures  are  set  up 
when  the  User  Inputs  are  completed  due  to 
the  fact  that  only  the  generation  of  errors 
will  require  further  Terminal  conversation. 
All  the  required  information  is  obtained  from 
the  Input  Files,  which  have  to  be  set  up  by 
the  user  prior  to  using  the  Tailoring  Tool. 
The  screen  will  show  what  tables  are  being 
produced.  These  are  local  data  structures 
and  are  provided  solely  for  the  Tailoring 
Tool's  benefit.  They  are  used  to  ensure  that 
all  the  files  have  been  processed  by  the 
Tailoring  Tool  at  the  end  of  the  run.  A 
definition  of  these  follows  : 

There  are  five  tables  defined  in  the 
tailoring  tool.  These  are  : 

Split  Files  Table 
Macro  Replacements  Table 
Special  Tests  Table 
-  Withdrawn  Tests  Table 

Not  Applicable  Tests  Table 
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4. 3.2.1  Split  Files  Table 
Function 

Used  by  the  Tailoring  Tool  to  hold  all 
the  split  file  names  associated  with  the 
implementation,  together  with  a  flag 
indicating  whether  the  file  has  been 
processed  by  the  tool  or  not.  There  are 
two  parts  to  this  table,  a  Split  Table 
and  a  Split  List.  The  Split  Table  holds 
the  name  of  the  test  file  which  is 
split,  and  the  Split  List  holds  the 
names  of  the  split  files  containing  the 
edits. 


Capacity 

Split  Table 
Split  List 


200  Test  Names 
200  File  Names 
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4. 3. 2. 2  Macro  Replacements  Table 
Function 

Used  by  the  Tailoring  Tool  to  hold  all 
the  macro  names  and  replacements 
associated  with  the  implementation, 
together  with  a  flag  indicating  whether 
the  replacement  has  been  made. 

Capacity 

Macro  Table  :  300  Macros 
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4. 3. 2. 3  Special  Tests  Table 
Function 

Used  by  the  Tailoring  Tool  to  store  all 
the  names  of  tests  which  are  classed  as 
being  special  in  the  log  book,  plus  a 
flag  indicating  whether  the  test  has 
been  processed  by  the  tailoring  tool. 

Capacity 

Special  Table  :  100  Test  Names 


Version  l.o 


July  1988 


Page  11 


90550-1 .UG 


4. 3. 2. 4  Withdrawn  Tests  Table 
Function 


Used  by  the  Tailoring  Tool  to  store  all 
the  names  of  the  tests  withdrawn  from 
the  ACVC  test  suite  plus  a  flag 
indicating  whether  the  test  names 
appeared  in  FNAMES. 


Capacity 


Withdrawn  Table  :  100  Test  Names 
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4. 3. 2. 5  Inapplicable  Tests  Table 
Function 


Used  by  the  Tailoring  Tool  to  store  all 
the  names  of  the  tests  not  applicable  to 
the  implementation,  plus  a  flag 
indicating  whether  these  tests  were 
processed  by  the  tailoring  tool. 

Capacity 

Inapplicable  Table  :  1000  Test  Names 
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4.3.3  Processes 

On  executing  the  Tailoring  Tool,  the  user 
will  see  the  terminal  screen  scroll  up  to 

clear  the  screen,  and  then  the  information  , 

defined  in  the  User  Inputs  section  will  be 
inquired  and  the  user  must  respond  before 
the  tool  will  continue. 

Having  completed  the  inputs  via  the  keyboard 
all  the  relevant  tables  will  be  produced. 

Once  the  tables  have  been  completed  the  sub¬ 
processes  using  these  data  structures  can 
proceed.  The  various  sub-processes  are  as 
follows  : 

a)  Filenames  are  read  in  from  FNAMES . 

These  are  checked  to  see  if  the  filename 
is  valid.  If  not  then  an  error  is 

raised  and  the  next  filename  is  read. 

b)  If  the  file  is  on  the  withdrawn  list 

then  no  further  processing  takes  place 
and  the  next  filename  is  read. 

c)  The  file  is  then  checked  to  see  if  it  is 

present  in  the  scope  of  the  Tailoring 

Tool,  and,  if  split  or  has  more  than 
one  module  then  the  subsequent  files  are 
also  checked  for  availability. 

d)  If  the  file  has  a  1 . TST '  extension  then 

this  indicates  to  the  Tailoring  Tool 

that  at  least  one,  macro  substitution  is 
required.  All  the  MAX_INT_LEN  dependent 
macros,  that  is  the  macros  that  rely  on 
the  maximum  line  length,  are  substituted 
together  with  those  macros  in  the  MACROS 
file. 
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5 


Input  Files 


Prior  to  using  the  Tailoring  Tool,  the  user  must  create  a 
number  of  ASCII  character  files.  These  files,  called  the 
Input  Files  are  used  to  supply  the  Tailoring  Tool  with  a 
list  of  all  the  filenames  within  a  particular 
classification.  The  Input  Files  are  : 

o  FNAMES 

o  MACROS 

o  SPLITS 

o  WDRNS 

o  SPCLS 

o  INAPPS 

o  TSINFO 

The  filenames  must  all  be  in  Chapter  order.  That  is 

alphabetically  within  each  class. 
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5. 1  List  of  all  Tests 

Filename  :  FNAMES 


Function 


Input  file  which  supplies  the  Tailoring  Tool  with  the 
names  of  the  test  files  used  in  the  current  version  of 
the  ACVC  test  suite  and  the  order  in  which  they  are  to 
be  processed. 

Contents 


A  sequential  list,  set  up  by  AVF's,  of  the  test  file 
names  in  the  ACVC  test  suite,  in  the  order  specified 
for  processing.  A  test  consisting  of  only  one  test 
file  is  indicated  by  a  seven  character  file  name, 
followed  by  the  extension.  Multiple  source  file  tests 
have  file  names  with  either  eight  or  nine  character 
file  names,  followed  by  their  extensions.  Nine 
character  names  indicate  which  of  the  files  is  the  main 
sub-test  unit,  the  main  sub-unit  having  an  'M'  in  the 
ninth  character  position  of  its  name. 

Format 


One  file  name  per  line. 


Example 

A21001A.ADA 
A38 199COM . ADA 
A38199C1 . ADA 

A38199C2 . ADA 


file  name  for  a  one  file  test 
main  unit  in  a  multiple  file  test 
second  unit  in  the  multiple  file 
test 

third  unit  in  the  multiple  file 
test 
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5.2  Macro  Names  and  their  replacements 
Filename  :  MACROS 


Function 


Input  file  which  supplies  the  Tailoring  Tool  with  a 
list  of  all  the  macro  names,  that  are  not  associated 
with  the  maximum  line  length,  together  with  their 
replacements,  which  define  the  implementation 
dependent  features  within  the  ACVC  test  suite  for  the 
particular  implementation  under  test. 

Contents 

A  list  of  records,  set  up  by  the  user,  containing  a 
macro  name,  followed  by  a  space,  and  the  associated 
replacement.  Comment  lines  are  optional  in  the  file 
(♦NOTE  2  in  Appendix  B) .  The  maximum  line  length  must 
be  the  first  macro  together  with  its  replacement.  The 
subseguent  list  contains  the  following  macro  names 
along  with  their  replacements.  For  implementations 
being  tested  under  ACVC  1.9,  the  macros  required  are 

$MAX_IN_LEN 

$NEG_BASED_INT 

$MAX_DIGITS 

$NAME 

$ INTEGER_FIRST 

$INTEGER_LAST 

$INTEGER_LAST_PLUS_1 

$MIN_INT 

$MAX_INT 

$MAX_INT_PLUS_1 

$LESS_THAN_DURATION 

$GREATER_TKAN_DURATION 

$GREATER_THAN_DURATION_BASE_LAST 

$COUNT_LAST 

$FIELD_LAST 

$  FI LE_NAME_WITH_BA  D_CHARS 
$FILE_NAME_WITH_WILD_CARD_CHAR 
$ILLEGAL_EXTERNAL_FILE_NAME1 
$ ILLEGAL  EXTERNAL  FILE  NAME2 
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Format 


One  macro  name  and  replacement  per  line,  separated  by 
one  space,  unless  the  replacement  goes  over  more  than 
one  line.  When  this  occurs  it  will  be  indicated  by 
in  the  last  character  of  each  line. 

Examples 

$MAX_IN_LEN  120 

$ I LLEGAL_EXTERNAL_FI LE_NAME2  THIS_FI LE_NAME_& 
WOULD_BE_PERFECTLY_LEGAL_IF_IT_& 

WERE  NOT  SO  LONG 
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5. 3  List  of  all  Split  Tests 
Filename  :  SPLITS 

Function 

Input  file  which  supplies  the  Tailoring  Tool  with  a 
list  of  the  split  file  names  associated  with  the 
implementation  under  test. 

Contents 

A  sequential  list  of  blocks,  each  block  containing 
information  about  each  test  file  in  the  ACVC  test  suite 
that  needs  to  be  split.  Comment  lines  are  optional 
within  the  file  (*NOTE  2  see  Appendix  B)  .  Each  block 
is  built  up  from  a  number  of  lines,  the  first  line, 
followed  by  a  space  and  the  number  of  extra  split 
files.  This  is  followed  by  a  sequential  list  of  all 
the  split  file  names. 

Format 

Testf ilename  Number_of_subsequent  files (N) 

Name  of  split  file  1 

Name  of  split  file  2 

Name  of  split  file  (N-l) 

Name  of  split  file  N 

Note  :  The  split  file  names  will  follow  the  agreed 

convention . 


Example 

The  following  file  is  a  single  test  file 
which  has  been  split  twice 

A2 1001A . ADA  2 
A2100100. ADA 
A2100101 . ADA 

The  following  sub-test  file  has  been 
split  once 

A38199C1. ADA  1 
A3819900. ADA 
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5. 4  List  of  all  Withdrawn  Tests 
Filename  :  WDRNS 


Function 

Input  file  which  supplies  the  Tailoring  Tool  with  a 
complete  list  of  the  withdrawn  tests  in  the  current 
ACVC  test  suite. 

Contents 

A  sequential  list  of  the  names  of  the  tests  withdrawn 
from  the  current  ACVC  test  suite. 

Format 


One  test  name  per  line. 

Examples 

A21001A. ADA 
A38199C. ADA 
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5. 5  List  of  all  Special  Tests 
Filename  :  SPCLS 

Function 

Input  file  which  supplies  the  Tailoring  Tool  with  a 
complete  list  of  the  tests  indicated  by  the  A  CVC  log 
book  as  being  special. 

Contents 

A  sequential  list  of  the  names  of  the  special  tests  in 
the  current  ACVC  test  suite  ( *NOTE  1  in  Appendix  E)  . 

Format 


One  test  name  per  line. 

Example 

LA5008C . ADA 
LA5008G. ADA 
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5.6 


Version 


List  of  all  Inapplicable  Tests 
Filename  :  INAPPS 


Function 

Input  file  which  supplies  the  Tailoring  Tool  with  a 
complete  list  of  the  tests  which  have  been  ruled  Not 
Applicable  for  this  implementation  by  the  AJPO  or  by 
not  supporting  various  features. 

Contents 


A  sequential  list  of  the  not  applicable  test  names  for 
the  particular  implementation  (*NOTE  1  in  Appendix  B) . 
The  file  may  also  contain  comments. 

Format 


One  test  name  per  line. 

Example  with  Comments 

'SIZE  representation  clauses  are  not 
supported 
C87B62A. DEP 

--  The  value  of  SYSTEM. MAX-DIGITS  IS  25 

C24113V. ADA 

C24113W. ADA 

C24113X.ADA 

C24113Y. ADA 


Example  without  Comments 

CE2102H. ADA 
C2  4113V. ADA 
C24113W. ADA 
C24113Y. ADA 
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5. 7  Information  File  on  the  Tests 
Filename  :  TSINFO 


Function 


Input  file  which  supplies  the  Tailoring  Tool  with  the 
details  of  the  current  ACVC  test  suite  in  order  that 
the  integrity  checks  for  completeness  may  be  carried 
out. 

Contents 

A  sequential  list  of  records  with  each  record 
indicatina  the  test  chapter,  test  type,  number  of 
applicable  tests  of  the  type,  number  of  not  applicable 
tests  of  the  type,  and  the  number  of  withdrawn  tests 
of  this  type,  in  the  chapter.  The  order  of  records  is 
the  same  as  that  of  FNAMES  (see  4.1). 

Format 


One  record  per  line. 

'Chapter'  'test  class'  'Nl'  'N2'  'N3' 

where  : 


Chapter  is  a  one  hexidecimal  character 

Test  Class  is  one  of  A,  B,  C,  D,  E,  L 

Nl  is  the  total  number  of  applicable  tests  of  the 
class  in  the  chapter 

N2  is  the  total  number  of  not  applicable  tests  of 
the  class  in  the  chapter 

N3  is  the  total  number  of  withdrawn  tests  of  the 
class  in  the  chapter. 

Example 

2  A  15  0  0 
2  B  39  0  1 
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Output  Files 

There  are  a  total  of  three  output  files. 
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o  ERR_OUT 

o  MCR0_0UT 

o  TTINF 

These  output  files  serve  the  following  purposes 


a) 

The 

input  file  for 

the 

Comparator 

and  Analyser 

Tool. 

b) 

To 

provide 

a  list 

of 

the  macro 

substitutions 

done  on 

the 

tests, 

and  a 

log 

of  what  messages  were  passed  to 

the 

screen 

for  a  validation. 
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6 . 1  Error  Logbook 

Filename  :  ERR  OUT 

Function 

To  supply  the  user  with  the  information  that  appeared 
on  the  screen  during  the  Tailoring  operation.  This 
file  gives  a  hard  copy  of  a1  ]  tne  output  from  the 
terminal  to  the  user,  including  any  error  messages, 
after  the  initial  guestions. 

Format 

A  printable  ASCII  character  file. 
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6. 2  Macro  Substitution  File 


Filename  :  MCRO  OUT 


Function 


To  supply  the  user  with  a  hard  copy  list  of  all  the 
macro  substitutions  that  taken  place  within  a 
Tailoring  run. 

Content 

a)  A  list  of  all  I  J_IN_LEN  dependant  macros. 

b)  A  list  of  all  the  macro  names  that  were 
substituted  within  the  ' . TST '  files. 

Format 

A  printable  ASCII  character  file. 
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6 . 3  Comparator  and  Analyser  Input  File 
Filename  :  TTINF 


Function 


This  file  allows  the  Tailoring  Tool  to  pass  parameters 
into  the  Comparator  and  Analyser  Tool.  It  is  only  a 
one  way  conversation  and  therefore  there  is  no  output 
file  from  the  Comparator  and  Analyser  Tool  that  the 
Tailoring  Tool  uses  as  an  input  file. 

Content 


This  file  provides  the  Comparator  and  Analyser  Tool 
with  the  following  information: 


a) 

Test  Name 

b) 

Number  of  subfiles 

c) 

Position  within  the  subfiles  of 
compilation  unit 

the  main 

d) 

Number  of  test  attributes 

e) 

List  of  any  subfiles 

f) 

List  of  any  test  attributes 

Once  all  the  tests  have  been  dealt  with  and  the 
information  written  to  the  TTTNF  rile,  the  Tailoring 
Tool  adds  a  completeness  check  count.  From  this  check 

count  the  Comparator  and  Analyser  Tool  can  reveal  an 
indication  of  how  much  confidence  the  user  can  put  on 
the  data  within  this  file. 

Format 


A  printable  ASCII  character  file. 
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Examde 

A39005F 

Test  name 

2  0  2 

Two  subfiles,  no 

— 

compilation  unit 

— 

attributes 

A3900501  — 

Subfile  1 

A3900502  — 

Subfile  2 

SPLIT 

File  is  Split 

SPCL 

File  is  Special 

The  comments  in  the  example  above,  that  is  the  text  to 
the  right  of  the  two  dashes  ( — ) ,  is  not  inserted  into 
the  output  file. 
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7 .  Error  Handling 

When  an  error  occurs  that  is  recoverable,  the  Tailoring 
Tool  will  ask  for  permission  to  continue.  The  only  loss 
that  will  occur  from  this  is  that  no  completeness  checks 
will  be  done. 

The  Error  messages  that  follow  are  found  in  the  output  file 
ERR  OUT  : 


*** INCORRECT  TESTNAME*** 
filename 


The  number  of  files  in  FNAMES  has  exceeded  the  bounds  of  the 
internal  array. 


***ERR0R  IN  SPLITS*** 

SPLIT  FILE  NOT  ASSOCIATED  WITH  FILE 
SPLIT  COUNT  MAY  BE  INCORRECT 
filename  from  splits  file 
THIS  FILE  WILL  BE  IGNORED 
filename  from  fnames  file 
THIS  FILE  WILL  BE  USED  AS  NEW  SPLIT 


The  naming  of  the  split  files  is  incorrect  (see  section 
3.2  of  this  document). 


***NUMBER  OF  SPLIT  FILES  NOT  GIVEN*** 
filename  from  fnames  file 
THIS  FILE  WILL  BE  IGNORED 


The  number  of  split  files  has  been  missed  out. 


***INVALID  MACRO*** 
macro  name  from  macros  file 
THIS  MACRO  WILL  BE  IGNORED 


There  is  a  macro  that  begins  with  $B  or  a  macro  that  does 
not  have  a  $  in  position  1  in  the  MACROS  file. 
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*  *  * MACRO  NAME  TOO  LONG*** 
macro  name  from  macros  file 
THIS  MACRO  WILL  BE  IGNORED 


Macro  name  is  greater  than  32  characters. 


***RE PLACEMENT  TOO  LONG*** 
macro  name  from  macros  file 
macro  replacement  from  macros  file 
THIS  MACRO  WILL  BE  IGNORED 


The  macro  replacement  is  too  long. 


***NO  REPLACEMENT  GIVEN  FOR  MACRO*** 
Macro  name 

THIS  MACRO  WILL  BE  IGNORED 


No  replacement  for  the  specified  macro  was  found  in  the 
MACROS  file. 


***UNABLE  TO  OPEN  FILE*** 
File  name 


Unable  to  open  the  specified  file. 


***PROCESS  WILL  TERMINATE  AFTER  THE  DATA  TABLES  HAVE  BEEN 
BUILT*** 


A  error  has  occurred  which  deems  the  continuation  of  this 
program  unproductive. 


***INCORRECT  NUMBER  OF  LINES  IN  THE  FILE*** 
File  name 


Trying  to  read  past  the  end  of  the  file. 
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***TEST  NOT  PROCESSED*** 
Test  name 


This  report  occurs  when  the  tool  finds  a  test  that  has  not 
been  processed. 


!!!***FILE  NOT  PROCESSED  FOR  SPLITS***!!! 
File  name 


Displayed  when  the  file  has  not  been  processed. 


! ! ! ***MACRO  NOT  BEEN  USED!!!*** 
Macro  name 


This  error  occurs  when  there  is  a  macro  that  has  not  been 
substituted. 


***! ! ! DIFFERENCE  IN  APPLICABLE  COUNT!!!*** 
CHAPTER  :  X  TEST  :  Y 

EXPECTED  :  A  ACTUAL  :  B 


This  report  is  printed  when,  in  the  completeness  checks, 
there  is  a  difference  between  the  TSINFO  file  and  what  the 
tool  has  calculated. 


***!!! DIFFERENCE  IN  NOT  APPLICABLE  COUNT!!!*** 
CHAPTER  :  X  TEST  :  Y 

EXPECTED  :  A  ACTUAL  :  B 


This  report  is  printed  when,  in  the  completeness  checks, 
there  is  a  difference  between  the  TSINFO  file  and  what  the 
tool  has  calculated. 
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***!!! DIFFERENCE  IN  NOT  WITHDRAWN  COUNT!!!*** 
CHAPTER  :  X  TEST  :  V 

EXPECTED  :  A  ACTUAL  :  B 


This  report  is  printed  when,  in  the  completeness  checks, 
there  is  a  difference  between  the  TSINFO  file  and  what  the 
tool  has  calculated. 


*** ! ! ! UNABLE  TO  OPEN  TSINFO!!!*** 
THE  COMP  ARRAY  WILL  NOT  BE  CHECKED 


The  TSINFO  file  has  not  been  opened  causing  the  failure  to 
run  the  completeness  checking. 


***!!! PROGRAM  TERMINATES!!!*** 

ERRORS  RAISED  WHILE  PROCESSING  TEST  FILES 


An  error  has  been  raised  while  processing  the  FNAMES  file. 


***!!! PROGRAM  TERMINATES!!!*** 

ERRORS  RAISED  WHILE  BUILDING  THE  TABLES 


An  error  occurred  in  building  the  internal  tables,  the 
program  has  insufficient  data  to  continue. 


***!!! PROGRAM  TERMINATES!!!*** 
UNABLE  TO  FIND  FNAMES. 


The  file  FNAMES  has  not  been  found. 


***!!!  PROGRAM  TERMINATES  !!'.*** 
UNABLE  TO  CREATE  OUTPUT  FILES 


The  output  file  could  not  be  created  because  of  illegal 
filename . 
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*** ! ! ! TWO  MAIN  FILENAMES  FOUND!!!*** 
File  name 


Two  identical  filenames  that  have  a  'M'  character  in 
position  9  have  been  found. 


*** ! ! ! ERROR  IN  FNANES !!!*** 
File  name 


The  length  of  the  filename  is  either  <  11  characters  or 

greater  than  13  characters. 


***!!! FNAMES  IS  EMPTY!!!*** 
PROCESS  WILL  TERMINATE 


No  filenames  in  FNAMES. 


*** ! ! ! UNABLE  TO  OPEN  SPLIT  FILE!!!*** 

split_f ilename 

THIS  FILE  WILL  BE  IGNORED 


The  split  file_name  is  an  illegal  filename. 


*** ! ! ! SPLIT  AND  TEST  IDS  ARE  DIFFERENT!!!*** 
TEST  ID  =  testid 
SPLIT  ID  =  split_id 


The  names  at  the  top  of  the  split  files  are  different. 


***!!  .'UNABLE  TO  OPEN  A  TEST  FILE'!!*** 


The  name  of  a  subfile  of  a  split  test  is  invalid. 
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*** ! ! !  UNABLE  TO  ADD  TEST  INTO  COMPLETENESS  COUNT  ARRAY!!!*** 


A  filename  with  meaningless  Test  types  or  chapter  has  been 
found. 


***!!! INVALID  MACRO  NAME!!!*** 
Macroname 

NO  REPLACEMENT  CAN  BE  MADE 


A  macro  ha-j  been  found  in  the  test  file  but  no  matching 
macro  has  been  found  in  the  MACROS  file. 
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AC  VC 
AJPO 

Alpha-numeric 

AVF 

Chapter  Order 

Character 

Comparator 
Analyser  Tool 

Decimal 

Logbook 

Macro 

Splits 


APPENDIX  A 
Glossary  of  Terms 


Ada  Compiler  Validation  capability. 

Ada  Joint  Programming  Office 
A  — >  z  ,  0  — >  9  inc. 

Ada  Validation  Facility. 

This  refers  to  the  order  that  the  tests 
filenames  appear  in  the  logbook. 

A  — >  z  inc. 

and  A  separate  and  complementary  tool  which 
takes  the  output  from  this  tool  and 
aids  checking  of  the  test  results. 

0  — >  9  inc. 

A  historical  record  of  tests  performance 
during  pre-validation  and  Validation. 

A  variable  name  that  ran  be  used  to 
substitute  implementation  dependent 
characteristics  at  the  time  of 
tailoring.  Used  to  help  the  portability 
of  the  ACVC  test  suite. 

These  are  tests  that  fcr  system 
requirements  have  to  be  edited  and  made 
into  more  than  one  subsequent  files 
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*  NOTE  1 


*  NOTE  2 


Notes 


For  a  single  file  test  the  test's  name  is  the 
same  as  the  file  name.  However,  for  multiple 
file  tests  the  test's  name  is  the  first  seven 
characters  of  the  test  file  names  plus  the 
extension,  as  specified  by  the  ACVC  Logbook. 

A  comment  may  appear  on  any  line  of  the  file, 
apart  from  the  last  line,  and  is  indicated  by 
'  — '  in  the  two  left  most  columns.  A  line 
beginning  with  '  — '  contains  no  more 
information. 
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APPENDIX  C 

of  Ada  Validation  Facilities 


AFNOR 

Tour  Europe,  Cedex  7 
F-92080  Paris  la  Defense 
France 


INDUSTRIEANLAGEN-BETRIEBSGESELLSCHAFT 
Dept.  SZT  ( IABG-AVF) 

Einsteinsstrasse  20 
D-8012  Ottobrunn 
West  Germany 

NATIONAL  COMPUTING  CENTRE  Ltd 
Oxford  Road 
Manchester 
Ml  7ED 

United  Kingdom 


ADA  VALIDATION  FACILITY  (ADS/SCEL) 

Bldg  676,  Rm  135,  Area  B 
Wright-Patterson  AFB ,  OH  45433-6503 

NATIONAL  BUREAU  OF  STANDARDS 
Institute  for  Computer  Sciences  and 

Technology 

Software  Standards  Validation  Group (Ada) 
Bldg  225,  Rm  A266 
Gaithersburg,  MD  20899 


1 

I 
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